package com.seafood.service;

import com.seafood.dto.*;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;

import java.math.BigDecimal;
import java.util.List;
import java.util.Map;

/**
 * 地图服务接口
 */
public interface MapService {
    
    /**
     * 地理编码（地址转坐标）
     */
    GeocodingResponseDTO geocoding(GeocodingRequestDTO requestDTO);
    
    /**
     * 逆地理编码（坐标转地址）
     */
    GeocodingResponseDTO reverseGeocoding(ReverseGeocodingRequestDTO requestDTO);
    
    /**
     * 批量地理编码
     */
    List<GeocodingResponseDTO> batchGeocoding(List<GeocodingRequestDTO> requests);
    
    /**
     * 计算两点间距离
     */
    Double calculateDistance(BigDecimal lat1, BigDecimal lon1, BigDecimal lat2, BigDecimal lon2);
    
    /**
     * 计算多点路径规划
     */
    Map<String, Object> calculateRoute(List<LocationAddressDTO> waypoints, String routeType);
    
    /**
     * 获取行政区划信息
     */
    Map<String, Object> getAdministrativeInfo(String province, String city, String district);
    
    /**
     * 坐标系转换
     */
    Map<String, BigDecimal> convertCoordinates(BigDecimal latitude, BigDecimal longitude, 
                                              String fromCoordType, String toCoordType);
    
    /**
     * 搜索周边POI
     */
    List<GeocodingResponseDTO.PoiInfoDTO> searchNearbyPoi(BigDecimal latitude, BigDecimal longitude, 
                                                         String keyword, Integer radius);
    
    /**
     * 获取地址建议（智能补全）
     */
    List<String> getAddressSuggestions(String keyword, String city);
    
    /**
     * 验证坐标有效性
     */
    boolean validateCoordinates(BigDecimal latitude, BigDecimal longitude);
    
    /**
     * 获取位置天气信息（集成天气API）
     */
    Map<String, Object> getLocationWeather(BigDecimal latitude, BigDecimal longitude);
}